home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / gsvw162b.zip / README.TXT < prev    next >
Text File  |  1996-08-01  |  9KB  |  239 lines
  1. ===============================================================
  2. README.TXT         1996-08-02
  3. ===============================================================
  4. GSview 1.62 beta - PostScript previewer.  Needs Ghostscript 4.01.
  5.  
  6. ========
  7. Overview
  8. ========
  9. GSview is a graphical interface for Ghostscript under MS-Windows
  10. or OS/2.  Ghostscript is an interpreter for the PostScript page 
  11. description language used by laser printers.
  12. For documents following the Adobe PostScript Document Structuring 
  13. Conventions, GSview allows selected pages to be viewed or printed.
  14. GSview must be used with Ghostscript 4.01.
  15.  
  16. Features include:
  17.  - view pages in arbitrary order (Next, Previous, Goto).
  18.  - selectable display resolution, depth, alpha.
  19.  - page size is automatically selected from DSC comments
  20.    or can be selected using the menu.
  21.  - orientation is automatically selected from DSC comments
  22.    or can be selected using the menu (Portrait, Landscape).
  23.  - single button zoom
  24.  - print selected pages using Ghostscript.
  25.    page offset can be applied.
  26.  - extract selected pages to another file.
  27.  - copy display bitmap to clipboard.
  28.  - save clipboard bitmap as BMP file.
  29.  - add bitmap or user preview to EPS file 
  30.    (Interchange, TIFF or Windows Metafile)
  31.  - graphically select and show bounding box for EPS file.
  32.  - extract bitmap preview or postscript from DOS EPS file.
  33.  - display PDF files
  34.  - on-line help.
  35.  - OS/2 or Win32 executables
  36.  - installation program for GSview and Ghostscript
  37.  - free (GSview Free Public Licence).
  38. New features in version 1.62 beta:
  39.  - Uses Ghostscript DLL.  Should now be faster and more robust.
  40.  - Anti-aliasing.
  41.  - More network friendly for installation.
  42.  - pstotext for improved text extraction and searching.
  43.  - better PDF support.
  44.  
  45. GSview was written by Russell Lang.
  46.  
  47. ============
  48. Installation
  49. ============
  50. Create three 1.44M floppies containing the following files, or
  51. put them all in the same directory on your hard disk.
  52.  
  53. Disk 1:
  54.   gsview.zip
  55.   README.TXT        (this file)
  56.   LICENCE
  57.   FILE_ID.DIZ
  58.   os2setup.exe      OS/2 installation program
  59.   os2unzip.exe      OS/2 Info-ZIP unzip utility
  60.   setup.exe         MS-Windows installation program
  61.   wizunz32.dll      MS-Windows Info-ZIP unzip utility
  62.   emxrt.zip         EMX Run Time library (OS/2 only).
  63.  
  64. Disk 2:
  65.   gs401ini.zip      Aladdin Ghostscript library files
  66.     PLUS
  67.   gs401w32.zip      MS-Windows Win32 Aladdin Ghostscript
  68.      OR 
  69.   gs401os2.zip      OS/2 Aladdin Ghostscript
  70.  
  71. Disk 3:
  72.   gs401fn1.zip      Aladdin Ghostscript fonts.
  73.  
  74. Disk 1 is the contents of gsvw160b.zip plus the file emxrt.zip obtained
  75. from ftp://ftp-os2.nmsu.edu/os2/unix/emx09b/emxrt.zip.
  76. Disks 2 and 3 are obtained from ftp://ftp.cs.wisc.edu/ghost/aladdin/
  77.  
  78. If using the floppy install method, 7Mbytes of hard disk space is required.
  79.  
  80. To install from OS/2, run 'os2setup.exe' from disk 1.
  81. Make sure that the zip files are transferred in binary mode and
  82. are all present.  The install program will not report bad zip files.
  83.  
  84. For MS-Windows 3.1, you must have Win32s installed before
  85. installing GSview.  See http://www.microsoft.com/ or
  86.   ftp://ftp.microsoft.com/softlib/mslfiles/pw1118.exe
  87. To install from MS-Windows, run 'setup.exe' from disk 1.
  88. The installation will overwrite any version of GSview or
  89. Aladdin Ghostscript in the destination directories.  If you
  90. wish to save your Fontmap file, back it up to another directory.
  91. Make sure that the zip files are transferred in binary mode and
  92. are all present.
  93.  
  94. If you don't like automatic installation programs, it is 
  95. possible to install GSview and Ghostscript manually.  See
  96. the Setup topic below for more details.
  97.  
  98. If you wish to use install GSview without any prompts, give
  99. a destination directory on the command line.  For example:
  100.   setup c:\gstools
  101. This will not prompt for a destination directory and will
  102. overwrite files without asking.
  103.  
  104. Configuration of GSview will occur the first time it is run.
  105.  
  106. ===========
  107. Compilation
  108. ===========
  109. To compile GSview for OS/2 you need IBM NMAKE.EXE and EMX/GCC 0.9b.
  110. To create the GSview online help you need the IBM toolkit.
  111. Copy gvpm.mak to Makefile and edit COMPBASE and EMXPATH as required.
  112. Type 'nmake'
  113.  
  114. To compile GSview for Windows you need Borland C++ 4.5.
  115. Copy gvwin.mak to Makefile then edit COMPBASE as required.
  116. Type 'make'.
  117.  
  118. =====
  119. Setup
  120. =====
  121. These are the manual setup instructions.
  122. It is recommended that you use the installation program
  123. as described in the Installation section above.
  124.  
  125. Create the directories gsview and gsN.NN (where N.NN is the
  126. Ghostscript version number).
  127.  
  128. Copy 
  129.   gvpm.exe, gvpgs.exe and gvpm.hlp (OS/2) and/or
  130.   gsview32.exe, gvwgs.exe, gsv16spl.exe and gsview.hlp  (MS-Windows)
  131.     and 
  132.   printer.ini
  133. to the GSview directory.  
  134. Unzip Ghostscript into the gsN.NN directory and the Ghostscript
  135. fonts into gsN.NN\fonts.
  136.  
  137. Start GSview and answer 'Yes' to all the configuration question.
  138. The configuration DEPENDS on ghostscript being in ../gsN.NN
  139. relative to the GSview directory.
  140.  
  141. GSview (gvpm.exe) will run under OS/2 2.1 and OS/2 Warp.  
  142. It may run under OS/2 2.0.
  143. PM GSview has been compiled with EMX/GCC 0.9b and requires
  144. the emx 0.9b DLL's.  These are available from
  145.   ftp://hobbes.nmsu.edu/os2/unix/emx09b/emxrt.zip
  146.  
  147. GSview (gsview32.exe) will run under Windows NT, Windows 95 and
  148. Windows 3.1/Win32s.  It will not run under Windows 3.0.
  149.  
  150. See the on-line help for more details.
  151. The 'Common Problems' topic is worth reading if GSview won't work.
  152.  
  153. ====
  154. Bugs
  155. ====
  156. Send bug reports to Russell Lang <rjl@aladdin.com>.
  157. (This is an alias provided by Aladdin Enterprises.  Russell Lang is not 
  158. an employee or agent of Aladdin Enterprises).
  159. When reporting bugs, please include the version number and date of 
  160. GSview (from the Help | About box), the version number of Ghostscript, 
  161. and the exact wording of any error messages.
  162. Do not send me large files (>100k bytes) unless requested.
  163. If you get a SYS3175 or GPF, please send the address of the GPF - I can 
  164. use this to help locate the bug.
  165. Please distinguish between bugs in GSview and bugs in Ghostscript.
  166. Don't expect a fast response - the work I'm paid to do has a higher
  167. priority.
  168.  
  169. =======
  170. Updates
  171. =======
  172. The latest version of GSview should be available from
  173.   ftp://ftp.cs.wisc.edu/ghost/rjl/gsview*.zip
  174. or by mail (see next section).
  175.  
  176. A World Wide Web home page for Ghostscript, Ghostview and GSview is at
  177.   http://www.cs.wisc.edu/~ghost/
  178.  
  179. ==================================
  180. Copyright, Licensing and Donations
  181. ==================================
  182. GSview is copyright by Russell Lang.
  183. GSview is distributed with the GSview Free Public Licence.
  184. This licence is contained in the file LICENCE.
  185. The GSview Free Public Licence does not require any payment to the author;
  186. however the author would welcome any donations to cover costs and time
  187. involved in developing and maintaining GSview.  These may be sent to
  188.     Russell Lang
  189.     12 Princetown Road
  190.     MOUNT WAVERLEY  VIC  3149
  191.     AUSTRALIA
  192. Donations are preferred in Australian dollars because it costs AUS$5
  193. to bank an overseas currency cheque.
  194. If the donation is over AUS$40 or US$40 then the author will mail 
  195. the next update to you on a 3.5" HD disk, provided you supply the 
  196. information below.  Updates are not likely to be frequent.
  197. Please accompany donations with the following information:
  198.     Your name.
  199.     Your postal address.
  200.     Your email address (if you have one).
  201.     Version number of GSview.
  202.     Where you obtained or heard about GSview.
  203.     Version number of Ghostscript.
  204.     Donation amount and currency.
  205.     Do you want updates to be mailed to you on disk?
  206.  
  207. The ps.c module is copyright by Tim Theisen and is covered by the
  208. licence in the file PUBLIC.
  209.  
  210. GSview uses Ghostscript to display the contents of the PostScript
  211. files.  Ghostscript is a separate program from GSview; it is
  212. written and owned by Aladdin Enterprises, not by Russell Lang.
  213.  
  214. Aladdin Ghostscript comes with a licence that is more restrictive than 
  215. the GNU Licence; in particular, it restricts the distribution of
  216. Aladdin Ghostscript in commercial contexts.  Please see the file PUBLIC
  217. that accompanies Aladdin Ghostscript for more details.  
  218.  
  219. GSview uses pstotext in an external DLL. pstotext was written by 
  220. Andrew Birrell and Paul McJones.  It is
  221.   Copyright (C) 1995-1996, Digital Equipment Corporation.
  222. See the licence in pstotext.txt or pstotext.zip for more details.
  223. If you do not agree to the pstotext licence, delete pstotext.zip,
  224. pstotxt2.dll and pstotxt3.dll.
  225.  
  226. ================
  227. Acknowledgements
  228. ================
  229. Tim Theisen, who wrote Ghostview for X11 which provided the inspiration
  230. for GSview.  Also for permission to use his ps.c module from Ghostview.
  231.  
  232. L. Peter Deutsch, for writing Ghostscript and for making changes to 
  233. Ghostscript to support GSview.
  234.  
  235. Paul McJones and Andrew Birrell of DEC, for making pstotext available 
  236. and making changes to it for use with GSview.
  237.  
  238. ==============================================================
  239.